Linkage with SCM system¶
Overview¶
In Next Design, in cooperation with Subversion which is a configuration management system, a series of file operations for the configuration management repository can be completed by UI operation on Next Design.
Below, the operation of Next Design linked with the configuration management repository is explained in the following order.
- Get the project from the repository and open it
- Get edit permission and start editing
- Release editing authority
- Get the latest from the repository
- Undo and undo changes
- Commit changes and update repository
- View commit log
- Register the project in the repository
- Manage repositories to register
Note
- Prepare a configuration management repository that works with Next Design in advance.
Retrieve from the repository and open¶
To retrieve and open a project from the repository, follow these steps from the Next Design start page:
Operating procedure
- Click Start> Get from Repository and Open... to display the Repository Selection dialog.
- Select the repository where the project is stored by one of the following methods and click the [Next] button.
- If you are using the configuration management repository for the first time in Next Design, or if the configuration management repository that contains the project is not registered, register the repository using the following procedure.
(1) Select [Register a new configuration management repository] and click the [Next] button.
(2) Enter the connection information to the configuration management repository and click the [Next] button. - If the configuration management repository where the project is stored is already registered, select that repository and click the [Next] button.
- If you are using the configuration management repository for the first time in Next Design, or if the configuration management repository that contains the project is not registered, register the repository using the following procedure.
- Select the project file to get by one of the following methods.
- Select a project from the project list displayed on the [Select Project File] tab.
- Switch to the Select from Folder tab and select the folder that contains the project file (.iproj) from the folder tree that appears.
- In [Check out to], specify the destination folder of the project file and click [Check out].
- If the project file is successfully obtained, the project file will be opened.
Attention
- Specify an empty new folder for the acquisition folder.
Get editing authority and start editing¶
To get editing privileges and start editing, do the following:
Operating procedure
- Select the project or model file to start editing with one of the following methods.
- Select the file in the project navigator.
- Select a project or model in the Model Navigator.
- Start editing in one of the following ways:
- From the ribbon, click Team Collaboration> Edit> Get edit permission/Get Edit Permission below Selected Model/Get all edit permission.
- Click Get edit permission from the context menu.
- When you start editing, the model file icon will switch and the model file will be marked with [(I am editing)] in the project navigator.
Release edit permission¶
To remove the editing authority, follow the procedure below.
To release the edit permission for the specified file
Operating procedure
- Select the project or model file for which you want to release the edit permission by one of the following methods.
- Select the project or model in the edited state in the model navigator.
- Select the file in edit status in the project navigator.
- Select the edit file in the Configuration Management Navigator.
- Use one of the following methods to cancel editing.
- Click [Team Collaboration]> [Edit]> [Release edit permission]/[Release Edit Permission below Selected Model] from the ribbon.
- Click Release edit permission from the context menu.
When canceling the edit permission for all files at once
Operating procedure
- From the ribbon, click Team Collaboration> Edit> Release All Edit Permission.
Attention
- If you remove the edit permission from the Configuration Management Navigator without committing the changes, the changed files will remain and will be inconsistent with the repository.
- To align with the repository, undo your changes by following "Undo and Undo Changes" below.
Get latest from repository¶
To update a previously retrieved file from the repository to the latest revision, follow these steps:
To check if it has been updated since it was previously acquired
Operating procedure
- From the ribbon, click [▼] at the bottom of Team Collaboration> Sync Repository> Get the Latest, and then click Check for updates.
If you want to update all files to the latest revision
Operating procedure
- Update to the latest revision using one of the following methods.
- Click on the icon for Team Collaboration> Sync Repository> Get the Latest from the ribbon.
- From the ribbon, click [▼] at the bottom of Team Collaboration> Sync Repository> Get the Latest, and then click Get All Files.
To update the specified file to the latest revision
Operating procedure
- Select the project or model file to update to the latest revision using one of the following methods.
- Select a project or model in the model navigator.
- Select the model file in the project navigator.
- Update to the latest revision using one of the following methods.
- From the ribbon, click [▼] at the bottom of Team Collaboration> Sync Repository> Get the Latest, and then click Update Selected File Only.
- Click Get the latest version of selected File from the context menu.
Note
- Files that have been acquired and changed are ignored, and other files are updated to the latest revision.
Undo and undo changes¶
To undo changes to an uncommitted file and revert to the original revision, follow these steps:
To revert all file changes
Operating procedure
- Switch the navigator to the Configuration Management navigator.
- Click Revert All from the Commit Target context menu.
- When the dialog for confirming the reloading of the project is displayed, click the [Yes] button.
To undo the changes in the specified file
Operating procedure
- Switch the navigator to the configuration management navigator.
- From the Commit Target in the Configuration Management Navigator, select the file whose changes you want to undo.
- Click Revert This File from the context menu.
- When the confirmation dialog for reloading the project is displayed, click the [Yes] button.
Attention
- The file whose changes have been undone has been deprived of edit privileges.
- If you want to continue editing, obtain editing authority again and start editing. *Committed changes cannot be undone on Next Design.
commit changes and update repository¶
To commit changes to a file and update the repository, do the following:
Operation procedure
- Save the modified file.
- Switch to the Configuration Management Navigator by doing one of the following:
- From the ribbon, click Team Collaboration> Sync Repository> Commit.
- Click SCM Navigator from the selector at the top of the navigator.
- Check the file displayed in [Commit Target]. By default, all modified files are checked for commit. If you want to exclude some files from commit, uncheck it.
- Enter the commit message.
- After entering the commit message, click the [Commit] button below the entry field or press the Ctrl+Enter key.
- This will update the files in the repository and add the commit log.
Tip
- If there are files that have been modified and saved but not committed, the icon in the Configuration Management Navigator will be marked.
- The icon for uncommitted files is marked for change.
Hint
- Check the Keep editable state checkbox at the bottom of Commit Target and then commit to allow each file to continue editing with edit permissions.
- By default, the check is unchecked, and the editing permission is released at the same time as the commit.
Attention
- It will not appear in Commit Target until you save the modified file.
- Please save and then commit.
Show commit log¶
To view the commit log for a file, do the following:
Operating procedure
- Select the project or model file for which you want to display the commit log by using one of the following methods.
- Select the file in the project navigator.
- Select a project or model in the Model Navigator.
- Select the file in the Configuration Management Navigator.
- View the commit log by doing one of the following:
- From the ribbon, click Team Collaboration> Sync Repository> Commit Log.
- Click Show commit log from the context menu.
- The Log Messages dialog appears, listing the commit logs for each revision.
- The list of commit logs can be filtered by specifying the start date and end date.
Register project to repository¶
To newly register a project that has not been registered in the repository in the repository, follow the procedure below.
Operating procedure
- Create a folder with the same name as the folder that will be added to the repository and move the project files and other packages.
- Open the project file in Next Design.
- From the ribbon, click Team Collaboration> SCM Repository> Registration to Repository.
- Select the repository where the project is stored by one of the following methods and click the [Next] button.
- If you are using the configuration management repository for the first time in Next Design, or if the storage destination repository is not registered, register the repository according to the following procedure.
- Select [Register a new configuration management repository] and click the [Next] button.
- Enter the connection information for the configuration management repository and click the [Next] button.
- If the storage destination repository is already registered, select the repository and click the [Next] button.
- If you are using the configuration management repository for the first time in Next Design, or if the storage destination repository is not registered, register the repository according to the following procedure.
- Select the folder where you want to store the project folder and click [Register].
- After successfully registering the repository, the Configuration Management Navigator can be selected as the navigator option.
Attention
- Be sure to register on Next Design when registering in the repository.
- If you register in the repository using a Subversion client tool other than Next Design, the configuration management system linkage function of Next Design may not work properly.
- Immediately after registering the repository, you are in the state where you are starting to edit the registered file set.
- If you do not want to edit after registering the repository, cancel the editing authority.
Manage repository registrations¶
Follow the steps below to register the configuration management repository in Next Design and change the registered connection information.
Operating procedure
- From the ribbon, click Team Collaboration> SCM Repository> Repository Management to display the Repository Management dialog.
- To register a new repository, press the [Add] button, then enter the connection information to the repository in the [Editing Repository Setting] dialog and press the [Add] button.
- To change the connection information of the registered repository, select the registered repository, click the [Edit] button, and then edit the connection information to the repository in the [Editing Repository Setting] dialog. Click the [OK] button.
- To delete the registered repository, select the registered repository, click the [Delete] button, and click the [OK] button in the confirmation message.
- To confirm the above changes, click the [OK] button in the [Repository Management] dialog.